home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 9 / The PC-SIG Library on CD ROM - Ninth Edition.iso / 801_900 / DISK0856 / DISK0856.ZIP / GROCERY.DOC < prev    next >
Text File  |  1989-09-19  |  13KB  |  331 lines
  1.  
  2.  
  3.  
  4.                              Grocery Listing Program
  5.  
  6.                                    Version 1.3
  7.  
  8.                                       -by-
  9.  
  10.                                   Jim D. Hart
  11.                            Synergy Software Solutions
  12.                                 904 Lariat Circle
  13.                               Papillion, NE  68128
  14.  
  15.  
  16.         Synergy  Software  Solutions  is distributing GROCERY  under  the 
  17.         "User Support" concept.   This program may be freely  distributed 
  18.         to  all  interested individuals without further authorization  or 
  19.         request from Synergy Software Solutions.   If you are  interested 
  20.         in  other programs  developed by SSS,  you can write to the above
  21.         address for information.
  22.  
  23.         Since  GROCERY  is  being  distributed  without  any  charge   or
  24.         obligation  by the user,  Synergy Software of Nebraska  disclaims
  25.         all  responsibilities for its purpose or its effectiveness.   (In
  26.         other words, "Don't look a gift horse in the mouth.")
  27.  
  28.         If you like and use this program,  a donation of $10 to the above
  29.         address  would  be greatly appreciated.  I am working on  a  much
  30.         modified  version that will be much better.   Write me and I will
  31.         send you information as it develops.  If you would like a copy of
  32.         the source code, the program was written in Turbo Pascal.  It can
  33.         be  obtained with the above mentioned $10 donation plus $10  more
  34.         for shipping and handling of a disk containing the source code.
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                         1
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.         Into the fire pit:
  71.  
  72.              There  are  those who grocery shop on a regular  basis  that 
  73.         often know precisely what they want to get, where to find it, and
  74.         how  many (or much) to buy.   Of course,  there are  those,  like 
  75.         myself,  who  dread the  local  Food-4-Less,  Piggly-Wiggly,  and 
  76.         Helter-Skelter  food chains;  who make illogical and often unsup-
  77.         ported  reasons why it is better to buy a dozen items at  the  7-
  78.         eleven  store  just down the street for the price of the  monthly 
  79.         car  payment rather than beat the hords of food shoppers  at  the 
  80.         BIG ones;  and who look for building maps at the entrance in case 
  81.         of  getting lost "somewhere" between isles 7 and 8 while  seeking 
  82.         the location of a jar of Jif.
  83.  
  84.              Well,  despite my efforts, the day came when my wife gave me 
  85.         the  grocery list and simply stated:  "Go to it."  It was in  the
  86.         two  hours  after this SEE (Significantly Emotional Event), while 
  87.         wearing  out  my  shoe soles in search of a  that  infintesimally 
  88.         small,  but ever so important, spice that I decided to write this 
  89.         program.
  90.  
  91.         The Program's Afoot:
  92.  
  93.              Within a day of previously described misadventure I had  the 
  94.         workings of the program complete.   At last!  Not only did I have
  95.         a  program  that I could use at the store,  but I  could  finally 
  96.         prove  to my wife that a computer DOES have useful  purposes.   I 
  97.         can  honestly  say now that having the  program  completed,  with 
  98.         several modifications as time goes on,  for nearly a year that my 
  99.         wife  consistently and faithfully uses it every time she goes  to 
  100.         her favorite grocery store.
  101.  
  102.         The Inner'ds:
  103.  
  104.              Since  there  is a built-in help screen (my wife  would  not
  105.         have  had  much  luck running the program without being  able  to
  106.         first  find the F1 key),  this document will be short.   It  will
  107.         only cover a general description of what the program does.
  108.  
  109.              First of all,  GROCERY is a data base program.   It contains
  110.         the  grocery  items you buy on a regular (or even  an  irregular)
  111.         basis,  along  with  the normal amount of each  item.   When  you
  112.         execute GROCERY, it will display the items by isle.  You can:
  113.  
  114.              1) enter new grocery items,
  115.              2) delete existing grocery items,
  116.              3) select grocery items to be printed, and
  117.              4) print the final grocery list (or entire data base).
  118.  
  119.              The  program  will handle up to 30 isles and each  isle  may
  120.         have up to 36 items.   The display shows the items three isles at
  121.         a time;  18 items per isle.   There are two "windows",  a top and
  122.         bottom,  that  can be switched between which enables you to  view
  123.         all 36 items (18 in the top window, 18 in the bottom window).
  124.  
  125.  
  126.  
  127.                                         2
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.              Items  are selected (or cleared) by placing the item  cursor
  138.         (an inverted color window)over the item you are interested in and
  139.         pressing  the RETURN key.   Once you have selected the items  you
  140.         wish  to include in the grocery list,  the F3 function key  sends
  141.         the list to the printer (LPT1:).
  142.  
  143.              Of course the difficult part about running the program is in
  144.         having  to  enter  ALL  of the items into the data  base  at  the
  145.         beginning.   The  nice  thing  is that once you  have  the  items
  146.         entered (and organized in the fashion you desire),  printing  the 
  147.         grocery  list is a snap;  and the print-out is organized by isle.  
  148.         All you have to do is go through the grocery store,  checking the 
  149.         items by the isle.
  150.              Isles in the program are numbered 1 to 30;  however,  I have 
  151.         added  a feature that allows you to change the name of the  isle.  
  152.         Thus,  you  can  rename one of the isles  "Produce"  and  another 
  153.         "Meats".  This also simplifies the shopping procedures.
  154.  
  155.         Key Points:
  156.  
  157.              A) The function keys
  158.  
  159.              F1: This  key  brings  up the first (of two)  help  screens.  
  160.                  These  screens provide a synopsis of the keys  that  are 
  161.                  available within the program.   To go to the second help 
  162.                  screen  page,  strike the F1 key again.   Any other  key 
  163.                  returns the main screen.
  164.  
  165.              F2: This  key  saves  the  present data base  to  the  file: 
  166.                  GROCERY.DB.   The data saved includes the items as  well
  167.                  as the selection settings.   Thus,  you can select items 
  168.                  to  be printed,  save them to file,  and when you reload 
  169.                  the program, the selection settings are still there.
  170.  
  171.              F3: This  key  prints out the final  grocery  listing.   All 
  172.                  print-out is organized by isle and the specific sequence 
  173.                  of items in the isles.
  174.  
  175.              F5: This key prints the entire data base.   This is good for
  176.                  checking the data base against the grocery  store;  just 
  177.                  print  out  the data base and take it with you the  next 
  178.                  time you go shopping.
  179.  
  180.              F7: This key resets all selected grocery items.  It is meant 
  181.                  primarily  to clear the selection settings so  that  you 
  182.                  can  start from scratch with the next grocery list.   If 
  183.                  you select this option,  GROCERY will give you one  last 
  184.                  chance to abort the action: with the ESC key.
  185.  
  186.              F9: This  key sets the display to the TOP window.   As  men-
  187.                  tioned above,  there are two windows required to display 
  188.                  all 36 items for each isle:  TOP and BTM (Bottom).  This 
  189.                  key and F10 are available to switch between the two.
  190.  
  191.  
  192.  
  193.                                         3
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.              F10:This  key  sets the display to the BTM (Bottom)  window.  
  203.                  See the F9 key above for more information.
  204.  
  205.  
  206.              B) Cursor Movement Keys
  207.  
  208.              The 4 Arrow Keys:
  209.  
  210.                   These keys are the primary keys to move the item cursor 
  211.              around  the display area of the screen.   The item cursor is 
  212.              used  to select or clear items for the grocery  listing,  to 
  213.              point to items to be deleted, or to point to locations where 
  214.              an item is to inserted in the list.
  215.                   In addition to the F9 and F10 keys described above, the 
  216.              arrow keys also can cause the display to switch between  the 
  217.              TOP and BTM windows.   If the cursor is placed over the last
  218.              item in the TOP window (and there are items that extend into 
  219.              the  BTM window),  the down arrow will cause the program  to 
  220.              display  the bottom window.   Likewise,  if the cursor is at 
  221.              the  first  item  on  the BTM window and  the  up  arrow  is 
  222.              pressed,  the program will display the top  window,  placing 
  223.              the cursor at the end of the top window's list.
  224.                   The  left  and right arrows "wrap" around  through  the 
  225.              three isles displayed.  To display the next three isles, use 
  226.              the page up and page down keys (described below).
  227.  
  228.              Home and End:
  229.  
  230.                   In  addition  the the arrow keys described  above,  the 
  231.              Home and End keys also move the cursor.   The Home key moves 
  232.              the  item cursor to the first item on that particular  isle.  
  233.              If the BTM window is displayed,  the window is not switched.  
  234.              The End key moves the cursor to the end of the list.
  235.  
  236.              C) Paging
  237.  
  238.                   GROCERY  only displays three isles of data at one time.
  239.              Each of these three isle displays are called  pages.   Since 
  240.              there  are 30 isles in all and three isles are displayed per 
  241.              page,  there are a total of 10 pages.   To move from page to 
  242.              page,  the PgUp and PgDn keys are used.   PgUp moves back to 
  243.              the  previous  page;  PgDn moves to  the  next.   For  quick 
  244.              "jumps",  holding the CTRL key down and striking the PgUp or 
  245.              PgDn  key will send you to the first page or the last  page, 
  246.              respectively.
  247.  
  248.              D) Other keys
  249.  
  250.              RETURN:  This  key is used to toggles the item pointed to by 
  251.              the item cursor between selected and cleared.  If an item is 
  252.              clear,  and the RETURN key is pressed,  GROCERY will ask you 
  253.              for the quantity.   If you don't wish to change the quantity 
  254.              as shown,  press the RETURN key again;  otherwise,  you  may 
  255.              type in a value between 1 and 99.
  256.  
  257.  
  258.  
  259.                                         4
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.              INS:  This  key allows you to insert new items into the data 
  269.              base.   To  insert a new item,  place the item cursor at the 
  270.              location you wish it to be and press the INS  key.   GROCERY 
  271.              will  ask you to enter the item.   Type in the name and  hit 
  272.              RETURN.  The item will be inserted.
  273.  
  274.              DEL:   This key deletes an existing item from the data base.  
  275.              Place  the  cursor over the item to be deleted and hit  DEL.  
  276.              GROCERY will ask you to verify the delete.  If you are sure, 
  277.              type "Y".
  278.  
  279.              CTRL-HOME:  As discussed above, it is possible to change the 
  280.              name of the isle which,  by default, is simply numbered from
  281.              1  to 30.   Text descriptors are often more  informative  of
  282.              what  the  isle contains,  rather than just  a  number.   To 
  283.              change the name, hold down the CTRL key and press Home.  The 
  284.              item  cursor will jump to the screen location displaying the 
  285.              isle number.  Now, just type in the name.  To clear the name 
  286.              from the display, press CTRL-Home and hit RETURN.
  287.  
  288.              ESC:   Finally,  to  exit  the program,  use  the  ESC  key.  
  289.              GROCERY  will ask you to verify this is what you wish to do.  
  290.              It  is  not necessary to save the data base to  file  before
  291.              exiting the program.   GROCERY will do this automatically if
  292.              you have updated any of the data.
  293.  
  294.  
  295.              NOTE: If you are using a color system and you don't like the
  296.              white on  blue color settings, or you cannot get the program
  297.              to work with  your monochrome system,  you can pass the pro-
  298.              gram a parameter to  change it to white on black.   When you
  299.              call the program, enter the following:
  300.  
  301.                      GROCERY /M
  302.  
  303.              This will  cause the  program to  act as if  it were a mono-
  304.              chrome system (all black and white characters).
  305.  
  306.  
  307.         That's it!   I hope you enjoy using this program.   It has been a
  308.         great value to my family and fun to write.
  309.  
  310.  
  311.  
  312.         Happy hunting...
  313.  
  314.  
  315.         Jim D. Hart
  316.         Synergy Software Solutions
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                         5
  326.  
  327.  
  328.  
  329.  
  330.  
  331.